home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / emenu110.zip / E-MENU.DOC next >
Text File  |  1991-12-01  |  17KB  |  371 lines
  1.         *******************************************************************
  2.         *            Welcome to E-Menu Version 1.10!                   *
  3.         *******************************************************************
  4.         ***** E-Menu 1.10 for the IBM PC,XT,AT, PS/2 or Compatibles    ****
  5.         ***** with 256K RAM, and a HardDrive or other non-floppy drive ****
  6.         ***** re-writeable storage device.                             ****
  7.         *****                                                          ****
  8.         *****   Supports MCGA, CGA, EGA, VGA and compatible Displays   ****
  9.         *******************************************************************
  10.         The following Files should be included with E-Menu:
  11.         
  12.         EMENU.EXE   - The E-Menu program.
  13.         EMENU.CMD   - Sample E-Menu command file.
  14.         FMTADOS.BAT - Sample DOS Batch File
  15.         E-MENU.DOC  - This File.
  16.  
  17.         Please feel free to distribute E-Menu, but please do not alter it or
  18.         any of the included files in any way.        
  19.  
  20.         *****************************************************************
  21.         Installing E-Menu
  22.         *****************************************************************
  23.         1. Choose the Drive you want to install E-Menu on. This must be
  24.            a hard drive, and cannot be a Floppy Drive. For example, type
  25.            C: to install E-Menu on drive C.
  26.  
  27.         2. Create a Subdirectory to contain the E-MENU Files.  We suggest
  28.            you name this directory EMENU.  To create the EMENU directory
  29.            on the C Drive, type:
  30.            >C:
  31.            >CD \
  32.            >MD EMENU
  33.  
  34.         3. Copy all the E-Menu files into this directory with the DOS 
  35.            copy command, and make it your current directory with the CD
  36.            command:
  37.            >CD \EMENU
  38.  
  39.         4. Edit or Recreate EMENU.CMD to set up your Menu choices.
  40.  
  41.         5. Edit your Autoexec.bat file, so that the final line reads,
  42.            C:\EMENU\EMENU.EXE, or the directory that you installed 
  43.            E-MENU in if it is different frome the example above.
  44.  
  45.         6. Restart your computer or Run EMENU.EXE.  E-Menu will create
  46.            the EMENU.CFG file, and prompt you to change startup options.
  47.         *****************************************************************
  48.  
  49.         E-Menu is an easy to install Menu program, designed to provide a
  50.         turnkey quality interface in minimum time with minimum effort. 
  51.  
  52.         E-Menu was intentionally designed to be simple, straightforward,
  53.         and easy to maintain.  E-Menu does not have multiple menu levels
  54.         which need to be set-up, and adjusted.  E-Menu automatically adjusts
  55.         itself in size and presentation to additions, deletions or changes
  56.         to the Menu command file, by expanding or contracting itself.  The
  57.         command file, EMENU.CMD is described in detail below.  
  58.  
  59.         E-Menu has been tested for hundreds of hours on a variety of systems,
  60.         and has been proven reliable and easy to use.
  61.  
  62.         E-Menu is ideal for individuals with a basic knowledge of Batch
  63.         file use, or for consultants who need to provide an attractive
  64.         bullet-proof menu for clients at a minimum cost.  E-Menu frees all
  65.         system memory to applications with the exception of about 4.5k +
  66.         the size of the Dos Command Interpreter (Command.com).  This may
  67.         add another 5-8k depending on the version of DOS installed.
  68.  
  69.         Unlike many other menu systems, E-Menu reads in menu selections
  70.         dynamically, generating a snaking picklist style menu of nearly
  71.         unlimited size.  In true picklist form, options which can not be
  72.         displayed on the first screen may be reached by scrolling the
  73.         screen downwards, and E-Menu maintains 'more' prompts which inform
  74.         the user of their relative location within the menu.
  75.         
  76.         Users select their menu choice by using the cursor keys to
  77.         highlight it. Hitting the Return key launches the chosen menu
  78.         selection.
  79.         Alternatively, users may search for commands by typing the first
  80.         letter of the the command title, which E-Menu highlights
  81.         automatically.  Holding this letter down will cause E-Menu to cycle
  82.         through all the choices which begin with a chosen letter. E-Menu
  83.         sorts all menu choices by default, although this option can be 
  84.         easily disabled through the E-Menu configuration feature.
  85.  
  86.         E-Menu automatically inserts an "Exit E-Menu" menu choice into 
  87.         the Menu.  E-Menu can also be Exited at any time, by hitting the
  88.         Escape Key.
  89.  
  90.         *******************************************************************
  91.         How E-Menu works.
  92.         *******************************************************************
  93.         EMENU.EXE utilizes two support files, the Menu Selection/Command file,
  94.         EMENU.CMD, which is a Dos Text file you create with an Editor, and a 
  95.         configuration file, EMENU.CFG, which is created and maintained by
  96.         E-Menu. These two files are described below.
  97.  
  98.         ---------
  99.         EMENU.CMD
  100.         ---------
  101.         This is the menu system command file.  It is a simple dos text (or
  102.         ASCII) file.  You need to create this file with an editor like 
  103.         the EDLIN.COM or EDIT.COM (New with DOS 5.0) programs provided with
  104.         DOS, or Edit the sample EMENU.CMD which comes with E-MENU 1.10.
  105.  
  106.         At startup E-Menu looks for the EMENU.CMD file in the location
  107.         specified in the EMENU.CFG file.  This defaults to the location
  108.         of the EMENU.EXE program file.
  109.  
  110.         Each line of the EMENU.CMD file describes one entry in the E-Menu.
  111.         Each line must be of the form:
  112.  
  113.         Title[Up to 20 Characters],Command(or BatchFile name)
  114.  
  115.         EMenu parses each line, seperating the Command from the command title
  116.         by examining the location of the comma.  Therefore, EMenu Titles can
  117.         not include a comma.  Otherwise there are no restrictions on how a
  118.         Title can be defined, as long as they are 20 characters or less in
  119.         length.
  120.         Commands are standard program names, subject to the standard DOS
  121.         filename restrictions.
  122.  
  123.         An example EMENU.CMD file with three entries might be: 
  124.         (Ignore Line Numbers and Arrows)
  125.                 123456789 1234567890  <= Max Description Length 20 Chars.
  126.                 --------------------
  127.         Line 1=>Wordperfect 5.1,WP51.BAT
  128.         Line 2=>Quattro Pro,QPRO.BAT
  129.         Line 3=>Check Disk,CHKDSK.EXE
  130.         Line 4=>Format/Bootable A:,FMTADOS.BAT
  131.        
  132.         E-Menu can execute commands directly if they're available on the
  133.         DOS path or in the E-menu batch directory, described below.  When
  134.         more complicated execution preparation is required, DOS batch files
  135.         may be used.  While the subject of batchfiles is beyond the scope
  136.         of this manual, a sample batchfile is illustrated below.
  137.  
  138.         *** When to use a batchfile! ***
  139.         Many programs accept parameters which run a program in a special
  140.         mode.  For example, the DOS FORMAT program allows you to specify
  141.         a /S parameter to format a disk with DOS transferred to it.  The
  142.         EMENU.CMD file does not allow you to specify a parameter to a program
  143.         directly.  Instead you must create a batchfile, with an editor,
  144.         like EDLIN and specify the parameter on the line that invokes the
  145.         program.  In the Sample batchfile FMTADOS.BAT, the line                                                                
  146.         
  147.  
  148.         *****************************************************************
  149.         Sample BatchFile FMTADOS.BAT
  150.         *****************************************************************
  151.         Echo Off
  152.         REM   Echo Off turns off display of subsequent commands.
  153.         REM   Lines beginning with REM for Remark, are comments
  154.         REM   and are ignored by the BatchFile processor.
  155.         REM   FMTADOS.BAT Formats the disk in Drive A:, and making it
  156.         REM   bootable with the /S command line option.
  157.         REM
  158.  
  159.         Echo Off
  160.         Format A: /S
  161.         
  162.         REM   End of FMTADOS.BAT
  163.         *******************************************************************
  164.  
  165.         Refer to your DOS manual for more information on how to create and
  166.         maintain batch files.  
  167.  
  168.         ---------
  169.         EMENU.CFG
  170.         ---------
  171.         When E-Menu is executed it begins by looking for the configuration
  172.         file EMENU.CFG.  If this file is not found, E-Menu will ask whether
  173.         or not to create it.  The CFG file must be in the same directory
  174.         as EMENU.EXE. After creating the configuration file, E-Menu brings
  175.         up the Configuration screen allowing you to tune a number of
  176.         options.
  177.  
  178.         These options can be tuned at a later time by using the Alt-C,
  179.         "Display Configuration file" hotkey at any time from within E-Menu. 
  180.         The Options available from within the Display Configuration File
  181.         menu are described below.
  182.  
  183.         --------------
  184.         E-Menu Hotkeys
  185.         --------------
  186.         F1 - Help
  187.         An Online Help screen is available by hitting the F1 key at any
  188.         time.
  189.  
  190.         ALT-A - About E-Menu.
  191.         This screen has information about E-Menu, and displays System and
  192.         EMS Memory.
  193.  
  194.         ALT-S - Shell to DOS
  195.         This feature lets you do an in-memory Shell to DOS. E-Menu uses
  196.         about 145K, and returns the rest for use by the Shell. Typing
  197.         EXIT will return you to E-Menu.
  198.  
  199.         ALT-C - E-Menu Configuration. See "Configuration file Options."
  200.         
  201.         *******************************************************************
  202.         Configuration file Options
  203.         *******************************************************************
  204.  
  205.         1. Menu Title
  206.         -------------
  207.         This appears at the top of the menu screen and can be customized
  208.         as desired.
  209.  
  210.         2. Batch Directory
  211.         ------------------
  212.         All files specified as executables in the Command file
  213.         should be placed in this directory.  The default is the same
  214.         directory as EMENU.EXE.
  215.  
  216.         3. Swap Directory
  217.         -----------------
  218.         E-Menu swaps itself out of memory before executing a command.  This
  219.         option allows you to modify the location of this swap file.
  220.  
  221.         4. Swap Message
  222.         ---------------
  223.         E-Menu will display a brief message when swapping itself in and out
  224.         of memory. You may turn this message off if you desire.
  225.  
  226.         5. Swap EMS
  227.         -----------
  228.         E-Menu will look for EMS memory and swap itself to EMS if
  229.         available.  You may choose to turn this option on, although the use
  230.         EMS by default is off.
  231.         EMS is considered an advanced option, and the use of EMS memory
  232.         may prevent other applications from making use of system EMS.  On the
  233.         other hand, EMS swapping is very fast, and can greatly speed the
  234.         performance of E-Menu when executing commands.  The ALT-A "About 
  235.         E-Menu" screen displays Available EMS memory. 
  236.  
  237.         6. Show Clock
  238.         -------------
  239.         While waiting for keystrokes, E-Menu updates a clock/calender on
  240.         the upper right hand corner of the screen.  This date and time is
  241.         derived from the system time.  You may disable the clock.
  242.  
  243.         7. Sort Menu Items
  244.         ------------------
  245.         E-Menu does not care about the order of commands in the EMENU.CMD
  246.         file.  By default, EMenu, will sort these lines, so the menu item
  247.         descriptions appear in sorted order.  If a special order is
  248.         desired, the EMENU.CMD file may be edited manually, and this option
  249.         may be disabled.
  250.  
  251.         NOTE: Changes to the E-Menu Configuration file do not take effect
  252.         until after you exit E-Menu and re-start it.
  253.  
  254.         *******************************************************************
  255.         Multi-user or LAN systems.
  256.         *******************************************************************
  257.  
  258.         E-Menu is not *designed* to be used on a LAN.  Individual copies
  259.         could be placed on the local hard-drive of each workstation, or
  260.         in seperate directories on the server, but care would need to be
  261.         taken that the configurable directories described above are unique
  262.         for each user.  This is because, E-Menu looks for it's EMENU.CFG
  263.         file in the same directory as EMENU.EXE.
  264.         A LAN version of E-Menu, E-MENU[L] is available for a fee of $25.00.
  265.         This version addresses the problems described above.
  266.  
  267.  
  268.          *******************************************************************
  269.                      New licensing Policy!   11/91
  270.         ********************************************************************
  271.  
  272.         If you choose to use E-Menu, a contribution would be appreciated. 
  273.         Our suggested Contribution is $9.00. 
  274.  
  275.         All users who contribute, will become registered users of E-Menu.
  276.         Registered users will be notified of future versions of E-Menu, and
  277.         will be entitled to Technical support.
  278.         We do not currently provide a printed manual, in order to keep the
  279.         cost of E-Menu low.
  280.  
  281.         ********************************************************************
  282.         All registered users will receive verification of their registration,
  283.         a Registration Number, and access to the Technical Support Phone
  284.         number.
  285.         Installation and evaluation questions or comments may be directed to
  286.         us through the mail, or via Compuserve.  See the "contacting us"
  287.         section at the end of this document.
  288.         ********************************************************************
  289.  
  290.         ----------------
  291.         Terms of License
  292.         ----------------
  293.  
  294.         E-Menu is distributed as is.  By using E-Menu you agree not to hold
  295.         the provider(s) of E-Menu liable for any damages whatsoever,
  296.         including  but not limited to, loss of profit, data or use of the
  297.         software, or special, incidental or consequential damages or other
  298.         similar claims, even if the provider(s) have specifically advised
  299.         of the possibility of such damages. In no event will the
  300.         provider(s) liability for any damages to you or any other person
  301.         ever exceed the lower of suggested list price or actual price paid
  302.         for the license to use the software, regardless of any form of the
  303.         claim.    
  304.  
  305.  
  306.         ********************************************************************
  307.         How to Contact the Provider(s) of E-Menu  (Contacting us!)
  308.         ********************************************************************
  309.  
  310.         We are interested in expanding and improving E-Menu.  We would 
  311.         appreciate your comments and suggestions, whether or not you've
  312.         decided to provide a donation.  Future versions of E-Menu will
  313.         be shaped by your suggestions.
  314.  
  315.         Electronically via Compuserve ID: 72267,2150
  316.  
  317.         Via US Mail @
  318.                 Tracy Barry/E-Menu
  319.                 616 Esplanade #101
  320.                 Redondo Beach, CA 90277
  321.  
  322.  
  323.        ********************************************************************
  324.                     E-Menu Registration Form
  325.         ********************************************************************
  326.         REMIT TO:
  327.         Tracy Barry/E-Menu
  328.         616 Esplanade #101
  329.         Redondo Beach, CA 90277
  330.  
  331.         ---------------------------------------------------------------------
  332.  
  333.                  Name:
  334.  
  335.               Address:
  336.  
  337.           City, State:
  338.  
  339.               ZipCode:
  340.  
  341.                 Phone:
  342.  
  343.         Compuserve ID:
  344.  
  345.         ---------------------------------------------------------------------
  346.         Quantity
  347.  
  348.         _____  of E-Menu single user license........ @ 9.00 each ____________
  349.  
  350.         _____  of E-Menu[L] LAN version license.... @ 25.00 each ____________
  351.     
  352.                                      Total Registration Fee _____________
  353.         Payment by:
  354.  
  355.           CHECK/MO ___
  356.               VISA ___
  357.         MASTERCARD ___     Credit Card#        -      -      -        
  358.  
  359.                            Expires:    /
  360.  
  361.          Credit Card Payments require an address and phone number.
  362.         ---------------------------------------------------------------------
  363.         Make Check or Money Order Payable to:
  364.  
  365.         Tracy Barry/ E-Menu
  366.         616 Esplanade #101
  367.         Redondo Beach, CA 90277
  368.  
  369.         Thank you!
  370.  
  371.